home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk194 / iconize / planes.readme < prev    next >
Text File  |  1995-03-19  |  10KB  |  189 lines
  1.  
  2. =============================================================================
  3.  
  4.           More colors on the Worbench Screen (The sequel) 11/25/87
  5.  
  6.                              By David M. Pochron
  7.                                (aka:  The MCP)
  8. =============================================================================
  9.  
  10.  
  11. OVERVIEW:
  12. --------
  13.     Here it is! What I thought originally would imvolve complex routines to
  14. open and close the WorkBench screen with more bitplanes and such, only
  15. required minimal programming. The OS in the Amiga is so versatile, it took
  16. the changes with open arms. (er, almost, that is)
  17.     Nevertheless, eight colors (or more) is possible on all Amigas now, with
  18. or without the KickStart in ROM. (That means you, Amiga 500 & 2000 owners!)
  19. The program ties into the screen structures and just appends a new bitplane on
  20. to it. That's it! The program can be executed at any time during the session,
  21. so you need not even alter the Startup-Sequence, (though that is the best
  22. time to activate the program)
  23.    The programs included with this ARC file are all 100% assembly language
  24. so the code is quite small. (Besides, I love assembly language!)
  25.  
  26.  
  27. WHAT YOU GET WITH THIS ARC FILE:
  28. -------------------------------
  29. ARCed Name:      Should be named as:   Description:
  30. ------------------------------------------------------------------------------
  31. Planes           BitPlanes             Program that makes 8/16 color WB!
  32. Planes.info      BitPlanes.info        Icon for the above program
  33. Readme           Readme                This file (duh!)
  34. Readme.info      Readme.info           Nice 8 color project icon for the file
  35. Disk.info        Disk.info             3 bitplane disk icon
  36. Trash.info       Trashcan.info         3 bitplane trashcan icon
  37. CLI.info         CLI.info              Alternate icon for CLI. (3 bitplanes)
  38. Drawer.info      Drawer.info           3 bitplane drawer icon
  39. Setcolor         SetColor              Program to set color registers 0-15
  40. Savecolor        SaveColor             Program to save the colors currently
  41.                                          being used on the WB screen
  42. Lauren.info      Lauren.info           *4* bitplane icon (the famous "Lauren"
  43.                                          pic, courtesy of NewTek's Digi-View!)
  44.                                          (with help from Butcher & Dpaint II!)
  45.  
  46.  
  47. USING THE BITPLANE PROGRAM:
  48. --------------------------
  49.    The BitPlanes program, which changes the number of bitplanes on the screen
  50. can be called from CLI or from Workbench. When using it from CLI, (the best
  51. place to use it) the format for the call is:
  52.  
  53. BITPLANES [n]    (where n is a value from 3 to 8)
  54.  
  55. For now, the only real "legal" values you can use are 3 or 4. A three will
  56. give you 8 colors, and a four will give you a maximum of 16 colors. If you
  57. give no value, it defaults to 3 bitplanes. If you have already installed the
  58. extra bitplanes and run the program again, any value passed in is ignored and
  59. the screen is toggled back to 2 bitplanes again. (the normal WorkBench screen)
  60.  
  61.    If you run this program from WorkBench by clicking on its icon, you can
  62. get a 16 color WB screen by keeping the left mouse button pressed after you
  63. double-click the icon. The program isn't going to take too long to load so
  64. you had better be fast! If you only want 8 colors, just double-click the icon
  65. and make sure the left mouse button is not pressed while the program executes.
  66. Again, if you run this program again after more colors have been installed,
  67. it will toggle back to a 4 color WorkBench screen no matter whether you are
  68. keeping the button depressed or not.
  69.    After the extra bitplanes are installed, it will probably be necessary to
  70. use the "Redraw" function under the Workbench "Special" menu, so all the
  71. icons are re-rendered in their full colors.
  72.  
  73.    Still, the best place to execute this program is at the beginning of a
  74. startup-sequence, since the WorkBench usually hasn't been loaded so all the
  75. menus and icons will come up rendered properly. Also, if you add bitplanes
  76. after a huge hunk of chip memory has been allocated by another program, and
  77. then that program deallocates that memory, the extra bitplanes will end up
  78. sitting like and island in the middle of chip memory. Not a good situation!
  79.  
  80.    One other note: this program works FINE with interlaced workbench
  81. screens!
  82.  
  83.    Finally, this program automatically sets the first 16 color registers to
  84. the values my icons included with this arc file need. If you want a different
  85. set of colors, use the Set&SaveColor programs (see below) or use a disk
  86. editor (like NewZap) and edit the RGB values. The data for these values is
  87. CLEARLY marked in the file as to where they begin, so changing the values
  88. should be no problem.
  89.    Note that the color registers are set WHENEVER the program is run - even
  90. when it is toggling back to 2 bitplanes, so keep that in mind.
  91.  
  92.    An interesting side effect: If you have another screen open at the time
  93. this program is run, the bitplanes will be modified for THAT screen! Don't
  94. know yet if this could serve any useful purpose, but it is interesting!
  95.  
  96.  
  97. SETCOLOR AND SAVECOLOR
  98. ----------------------
  99.    These programs are similar to the Set & Save color programs included in
  100. the original KickStart mod, except they set all colors from 0 to 15. They
  101. still use the file "Color.palette" as the source & destination file. Since
  102. the BitPlanes program automatically sets the colors when it is run, these two
  103. files are actually not really necessary. I included them just in case you
  104. didn't have a disk editor to change the default colors in BitPlanes and you
  105. wanted your own set of colors. (You will need a program like PopColors,
  106. however, to set your own RGB values on the screen before saving them.)
  107.  
  108.  
  109. MAKING 8 & 16 COLOR ICONS:
  110. -------------------------
  111.    Obviously, you can't use the existing icon editor anymore if you want to
  112. create icons with more than four colors. Until someone writes an icon editor
  113. with a variable # of bitplanes, a utility to make IFF brushes into icons will
  114. usually do the trick. Some icon zappers (as they are called) won't create
  115. icons with more than 3 bitplanes, so depending on the icon zapper you have,
  116. you may be limited to just 8-color icons.
  117.    To make Lauren an icon, I used DigiView 2.0 to convert her to a B&W image,
  118. then went to Dpaint II and removed the background. I then used Butcher to fit
  119. the image into the color registers I wanted and finally used an icon zapper
  120. written in BASIC from a recent Compute! magazine. (Which did convert 4
  121. bitplane brushes to icons just fine.)
  122.  
  123.  
  124. CAVEAT EMPTOR: (or let the user beware!)
  125. -------------
  126.    Okay, as in the text that went with my previous KickStart mod, some icons
  127. don't work quite right when extra bitplanes are added. Also, backfill doesn't
  128. work with icons having more than 2 bitplanes. All 2 bitplane icons work fine
  129. with the mod, though animated ones won't show when they are dragged - add a
  130. bitplane to 'em and they'll work fine. Again, although the OS exhibits no
  131. real problems when more planes are added, if you run it from an icon, the
  132. menus may not get rendered properly the first few times they are used. Also,
  133. if a window is covering a CLI window when the program is run from an icon,
  134. garbage will appear in part of the CLI window that was covered. Drag &
  135. resize the CLI window to clear out this garbage. (If you run the program at
  136. the beginning of a startup-sequence, none of these rendering problems will
  137. occur, of course!)
  138.    The biggest caveat is the fact that although the program will let you have
  139. 4 bitplanes on a WorkBench screen, the computer slows down to a speed that
  140. makes it almost unusable. Use 4 bitplanes only for demoing purposes.
  141. (ie: "wow" your Mac & ST friends by inserting a disk and having your
  142. digitized face come up as the disk icon!) Use 3 bitplanes for normal computer
  143. use. If you really need digitized icons during normal everyday use, consider
  144. setting the first 8 color registers to 8 shades of grey and then use dithering
  145. to get 16 shades. This should look even better than the Lauren icon, as it
  146. only uses *12* of 16 shades available on the Amiga.
  147.  
  148.  
  149. RULES:
  150. -----
  151.    Okay, this program is almost as "PD" as "PD" can get. You can hack at it
  152. all you like, include it in commercial software with no fees whatsoever, and
  153. pass it around as you like. (in fact, I encourage it!) The only thing I ask is
  154. you not change the credits & version info located within the BitPlane program
  155. itself. This text file you are reading does not need to be included with any
  156. commercial software the BitPlane program is used with. People uploading this
  157. ARC file to other BBSes, however, ought to leave this document intact,
  158. included with the other files.
  159.    The icons, of course, are free for everyone to use - even Commodore-Amiga
  160. in their Amiga 3000! (grin)
  161. (PS: except Lauren - I don't know how NewTek would take to seeing their
  162. picture show up in someone else's commercial software!)
  163.  
  164.  
  165. FUTURE IMPROVEMENTS:
  166. -------------------
  167.    The first thing I'd like to do is to remove the "toggle back to 2
  168. bitplanes" when run from CLI and instead have the user just enter the # of
  169. bitplanes they want on the screen - any number from 1-8! No hassle, no fuss.
  170. Also, I hope to have it check for a Color.palette file and load it if it
  171. finds one. That way, the user wouldn't have to use separate program to set
  172. his own preferences for the color registers. Other future enhancements may
  173. include a color palette editor built-in and a # of bitplanes requester for
  174. WorkBench users. If you have any suggestions (or, heaven forbid!) find a bug,
  175. you can reach me on CompuServe via _EMAIL_ (I don't get on too often, and
  176. messages on the Amigaforum scroll off so quickly!) at user # 72517,2102. Or,
  177. a much faster way is to call one of the following BBSes:
  178.  
  179. S.A.R. BBS     305-266-6178  Leave message to  "THE MCP *SYSOP*"
  180.    -or-
  181. VikenHolm BBS  305-258-0862  Leave message to  "THE MCP"
  182.    (note: call here _ONLY_ between 5PM and 7AM EST)
  183.  
  184.  
  185. That's all for now! Enjoy having more colors on Workbench! Who knows...a HAM
  186. WorkBench might just be around the corner!
  187.  
  188.                                       - David M. Pochron
  189.